
<html><HEAD>
<LINK REL=STYLESHEET HREF="default.css" TYPE="text/css">
<TITLE>
Working with tools</TITLE>
</HEAD>
<BODY>

<!-- Header -->
<p class="ancestor" align="right"><A HREF="pbugp12.htm">Previous</A>&nbsp;&nbsp;<A HREF="pbugp14.htm" >Next</A>
<!-- End Header -->
<A NAME="CHDDGBCD"></A><h1>Working with tools</h1>
<A NAME="TI332"></A><p>PowerBuilder provides a variety of tools to help you with
your development work. There
are several ways to open tools:<A NAME="TI333"></A>
<ul>
<li class=fi>Click a button
in the PowerBar for the tool you want</li>
<li class=ds>Select the tool from the Tools menu</li>
<li class=ds>Open the New dialog box and select the tool you
want on the Tool tab page
</li>
</ul>
</p>
<A NAME="TI334"></A><p><A HREF="pbugp13.htm#CEGHCGIJ">Table 1-5</A> lists the tools available in the PowerBar.
Some of these tools are also listed on the Tools menu.</p>
<A NAME="CEGHCGIJ"></A><table cellspacing=0 cellpadding=6 border=1 frame="void" rules="all"><caption>Table 1-5: Tools available in the PowerBar</caption>
<tr><th  rowspan="1"  ><A NAME="TI335"></A>Tool</th>
<th  rowspan="1"  ><A NAME="TI336"></A>What you use the tool for</th>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI337"></A>To-Do List</td>
<td  rowspan="1"  ><A NAME="TI338"></A>Keep track of development tasks you need
to do for the current target and create links to get you quickly
to the place where you need to complete the tasks. For information,
see <A HREF="pbugp13.htm#CAICEGHE">"Using the To-Do List"</A>.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI339"></A>Browser</td>
<td  rowspan="1"  ><A NAME="TI340"></A>View information about system objects
and objects in your target, such as properties, events, functions,
and global variables, and copy, export, or print the information.
For information, see <A HREF="pbugp117.htm#CBBCFJHA">"Browsing the class
hierarchy"</A>.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI341"></A>Library painter</td>
<td  rowspan="1"  ><A NAME="TI342"></A>Manage libraries, create a new library,
build dynamic libraries, and use source control.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI343"></A>Database profiles</td>
<td  rowspan="1"  ><A NAME="TI344"></A>Define and use named sets of parameters
to connect to a particular database. For information, see <i>Connecting
to Your Database.</i>
</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI345"></A>Application Server profiles</td>
<td  rowspan="1"  ><A NAME="TI346"></A>Define and use named sets of parameters
to connect to a particular application server. For information,
see <i>Connecting to Your Database.</i>
</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI347"></A>Database painter</td>
<td  rowspan="1"  ><A NAME="TI348"></A>For information, see <A HREF="pbugp137.htm#BFCDFDFD">Chapter 16, "Managing the Database."</A></td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI349"></A>File Editor</td>
<td  rowspan="1"  ><A NAME="TI350"></A>Edit text files such as source, resource,
and initialization files. For information, see <A HREF="pbugp13.htm#X-REF342804944">"Using the file editor"</A>.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI351"></A>Debugger</td>
<td  rowspan="1"  ><A NAME="TI352"></A>Set breakpoints and watch expressions,
step through your application, examine and change variables during
execution, and view the call stack and objects in memory. For information,
see <A HREF="pbugp262.htm#CAICJCBI">Chapter 32, "Debugging and Running Applications ."</A></td>
</tr>
</table>
<A NAME="TI353"></A><p><A HREF="pbugp13.htm#CEGBBAFH">Table 1-6</A> lists
the tools you can launch from the Tool tab page in the New dialog
box. You can also launch the Library painter and File Editor from
this dialog box.</p>
<A NAME="CEGBBAFH"></A><table cellspacing=0 cellpadding=6 border=1 frame="void" rules="all"><caption>Table 1-6: Additional tools available in
the New dialog box</caption>
<tr><th  rowspan="1"  ><A NAME="TI354"></A>Tool</th>
<th  rowspan="1"  ><A NAME="TI355"></A>What you use the tool for</th>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI356"></A>Migration Assistant</td>
<td  rowspan="1"  ><A NAME="TI357"></A>Scans PowerBuilder libraries and highlights
usage of obsolete functions and events. For information, see the Migration
Assistant online Help.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI358"></A>DataWindow Syntax</td>
<td  rowspan="1"  ><A NAME="TI359"></A>Helps construct the syntax required by <b>Modify</b>, <b>Describe</b>, and <b>SyntaxFromSQL</b> functions.
For information, see DataWindow Syntax online Help.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI360"></A>Profiling Class View, Profiling Routine
View, and Profiling Trace View</td>
<td  rowspan="1"  ><A NAME="TI361"></A>Use trace information to create a profile
of your application. For information, see <A HREF="pbugp266.htm#CAICJCMK">Chapter 33, "Tracing and Profiling Applications ."</A></td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI362"></A>Web DataWindow JavaScript Generator</td>
<td  rowspan="1"  ><A NAME="TI363"></A>Generate a JavaScript file that contains
DataWindow methods you want to associate with a specific DataWindow
object. For information, see the <i>DataWindow Programmers
Guide</i>
.</td>
</tr>
</table>
<A NAME="CAICEGHE"></A><h2>Using the To-Do List</h2>
<A NAME="TI364"></A><p>The To-Do List displays
a list of development tasks you need to do. You can create tasks
for any target in the workspace or for the workspace itself. A drop-down
list at the top of the To-Do List lets you choose which tasks to display.
To open the To-Do List, click the To-Do List button in the PowerBar or
select Tools&gt;To-Do List from the menu bar.</p>
<A NAME="TI365"></A><h4>To-Do List entries</h4>
<A NAME="TI366"></A><p>The entries on the
To-Do list are created:</p>
<A NAME="TI367"></A><p><A NAME="TI368"></A>
<ul>
<li class=fi>Automatically by most PowerBuilder wizards
to guide you through the continued development of objects of different
types that you will need to build the application or component specified
by the wizard</li>
<li class=ds>At any time by you when you are working in a painter
and want a link to a task that you want to remember to complete
</li>
</ul>
</p>
<A NAME="TI369"></A><p>Some To-Do List entries created by wizards are hot-linked
to get you quickly to the painter (and the specific object you need)
or to a wizard. You can also create an entry yourself that links
to the PowerBuilder painter where you are working so you can return
to the object or script (event/function and line) you were
working on when you made the entry. When you move the pointer over entries
on the To-Do list, the pointer changes to a hand when it is over
a linked entry. </p>
<A NAME="TI370"></A><p>For example, if you
generate an MDI application with the Template Application wizard,
one of the linked entries on the To-Do List reminds you to register
new sheets with the sheet manager service, which is a nonvisual
user object created by the wizard. Double-clicking this
entry automatically opens the Window painter and the Script view
where you register new sheets.</p>
<br><img src="images/ui19.gif">
<A NAME="TI371"></A><h4>Exporting and importing lists</h4>
<A NAME="TI372"></A><p>You can export or import a To-Do List by selecting Export
or Import from the pop-up menu. Doing this is useful if you want
to move from one computer to another or you need to work with To-Do
Lists as part of some other system such as a project management
system. </p>
<p><img src="images/note.gif" width=17 height=17 border=0 align="bottom" alt="Note"> <span class=shaded>Linked entries</span> <A NAME="TI373"></A>If you import a list from another workspace or target, or
from a previous version of PowerBuilder, linked entries will display
in the list but the links will not be active.</p>
<A NAME="TI374"></A><h4>Working with entries on the To-Do List</h4>
<A NAME="TI375"></A><p><A HREF="pbugp13.htm#CEGFCDIF">Table 1-7</A> tells you how to work with entries
on the To-Do List.</p>
<A NAME="CEGFCDIF"></A><table cellspacing=0 cellpadding=6 border=1 frame="void" rules="all"><caption>Table 1-7: Using the To-Do List</caption>
<tr><th  rowspan="1"  ><A NAME="TI376"></A>To</th>
<th  rowspan="1"  ><A NAME="TI377"></A>Do this</th>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI378"></A>See linked entries</td>
<td  rowspan="1"  ><A NAME="TI379"></A>Move the pointer over the entries. A
hand displays when the entry you are over is linked.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI380"></A>Use a linked entry to get to a painter
or wizard</td>
<td  rowspan="1"  ><A NAME="TI381"></A>Double-click the linked entry or select
it and then select Go To Link from the pop-up menu.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI382"></A>Add an entry with no link</td>
<td  rowspan="1"  ><A NAME="TI383"></A>Select Add from the pop-up menu.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI384"></A>Add a linked entry to a painter that
edits objects</td>
<td  rowspan="1"  ><A NAME="TI385"></A>With the painter open, select Add Linked
from the pop-up menu.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI386"></A>Add an entry for a specific target</td>
<td  rowspan="1"  ><A NAME="TI387"></A>If the To-Do List is open, select the
target from the drop-down list at the top of the To-Do
List and add the entry.<A NAME="TI388"></A><p>If the To-Do List is closed, select a target in the System Tree,
open the To-Do List, and add the entry.</p></td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI389"></A>Add an entry for the workspace</td>
<td  rowspan="1"  ><A NAME="TI390"></A>Select Current Workspace from the drop-down
list at the top of the To-Do List and add the entry.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI391"></A>Change the list that displays</td>
<td  rowspan="1"  ><A NAME="TI392"></A>Select a specific target or Current Workspace
from the drop-down list at the top of the To-Do List. To
display tasks for all targets and the workspace, select All Items.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI393"></A>Change an entry's position on
the list</td>
<td  rowspan="1"  ><A NAME="TI394"></A>Drag the entry to the position you want.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI395"></A>Edit or delete an entry</td>
<td  rowspan="1"  ><A NAME="TI396"></A>Select Edit or Delete from the pop-up
menu.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI397"></A>Delete checked entries or all entries</td>
<td  rowspan="1"  ><A NAME="TI398"></A>Select Delete Checked or Delete All from
the pop-up menu.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI399"></A>Check or uncheck an entry</td>
<td  rowspan="1"  ><A NAME="TI400"></A>Click in the margin to the left of the
entry or select an entry and then select Check/Uncheck
from the pop-up menu.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI401"></A>Export a To-Do List</td>
<td  rowspan="1"  ><A NAME="TI402"></A>Select Export from the pop-up menu, name
the To-Do List text file, and click Save.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI403"></A>Import a To-Do List</td>
<td  rowspan="1"  ><A NAME="TI404"></A>Select Import from the pop-up menu, navigate
to an exported To-Do List text file, and click Open.</td>
</tr>
</table>
<A NAME="X-REF342804944"></A><h2>Using the file editor</h2>
<A NAME="TI405"></A><p>One of the tools on the PowerBar and Tools menu is a text
editor that is always available. Using the editor, you can view
and modify text files (such as initialization files and tab-separated
files with data) without leaving PowerBuilder. Among the features the file editor provides
are find and replace, undo, importing and exporting text files,
and dragging and dropping text.</p>
<A NAME="TI406"></A><h4>Setting file editing properties</h4>
<A NAME="TI407"></A><p>The file editor has font properties and an indentation property
that you can change to make files easier to read. If you do not
change any properties, files have black text on a white background
and a tab stop setting of 3 for indentation. Select Design&gt;Options
from the menu bar to change the tab stop and font settings.</p>
<p><img src="images/note.gif" width=17 height=17 border=0 align="bottom" alt="Note"> <span class=shaded>Editor properties apply elsewhere</span> <A NAME="TI408"></A>When you set properties for the file editor, the settings
also apply to the Function painter, the Script view, the Source
editor, the Interactive <ACRONYM title = "sequel" >SQL</ACRONYM> view in
the Database painter, and the Debug window.</p>
<A NAME="TI409"></A><h4>Dragging and dropping text</h4>
<A NAME="TI410"></A><p>To move text, simply select it, drag it to its new location,
and drop it. To copy text, press the Ctrl key while you drag and
drop the text.</p>

